Skip to main content

DataBoundControl Methods

An object defining methods for the DataBoundControl class.

ScrollTo()

Scrolls to the control.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


HideLoading()

Removes the loading state from the control.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


FireClick()

Triggers the Click event.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnInit(sender, e)

Raises the Init event.

Parameters:

sender (required): object
The source of the event.

e (required): InitEventArgs
The initialization event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


Hide()

Hides the control.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnPropertyValueGet(sender, e)

Raises the PropertyValueGet event.

Parameters:

sender (required): object
The source of the event.

e (required): GetControlPropertyValueEventArgs
The property value get event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


Show()

Makes the control visible.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


Equals(other)

Determines whether the specified DataBoundControl is equal to the current control.

Parameters:

other (required): DataBoundControl
The control to compare with the current instance.

Returns:

Type: bool
true if the specified control is equal to the current control; otherwise, false.

This is a sync method. Method runs synchronously.


OnDataLoad(sender, e)

Raises the DataLoad event with the provided arguments.

Parameters:

sender (required): object
The source of the event.

e (required): DataLoadEventArgs
The event data containing the payload to load.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnRender(sender, e)

Raises the Render event.

Parameters:

sender (required): object
The source of the event.

e (required): RenderEventArgs
The render event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnLoad(sender, e)

Raises the Load event.

Parameters:

sender (required): object
The source of the event.

e (required): LoadEventArgs
The load event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetProtectedData(isDisabledOrReadOnly)

#import (Bimser.CSP.FormControls.Base.ICanProtectData.GetProtectedData(bool)) (shortDescription)

Parameters:

isDisabledOrReadOnly (required): bool
Indicates whether to include only properties that must be protected when the control is disabled or read-only.

Returns:

Type: Dictionary<string, object>
Returns a dictionary of protected properties and their values for integrity verification.

This is a sync method. Method runs synchronously.


ToggleLoading()

Toggles the loading state of the control.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetDifferences(otherObj)

Compares the current instance with another control and returns the differences.

Parameters:

otherObj (required): object
The object to compare with.

Returns:

Type: Dictionary<string, object>
A dictionary of differences between the current instance and the other control.

This is a sync method. Method runs synchronously.


SetPropertyValue(mapping, value)

Sets the value of a property specified by a mapping.

Parameters:

mapping (required): List<string>
A list of strings defining the property path.

value (required): object
The value to set for the property.

Returns:

Type: void
Method does not return anything


ClearDefaultValue()

Clears the control’s default value. Can be overridden in derived classes.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnPropertyChanged(sender, e)

Handles the property changed event.

Parameters:

sender (required): object
The source of the event.

e (required): PropertyChangedEventArgs<object>
The property changed event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetValueAsObject()

Gets the current value of the control as a generic object. Override to return meaningful data in derived types.

Returns:

Type: object
The control value as an object.

This is a sync method. Method runs synchronously.


ShowLoading()

Sets the control to a loading state.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnPreRender(sender, e)

Raises the PreRender event.

Parameters:

sender (required): object
The source of the event.

e (required): PreRenderEventArgs
The pre-render event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetDifferences(otherObj)

Compares the current control with another and returns a dictionary of differences.

Parameters:

otherObj (required): object
The object to compare against.

Returns:

Type: Dictionary<string, object>
A dictionary of property differences.

This is a sync method. Method runs synchronously.


Equals(obj)

Determines whether the specified object is equal to the current control.

Parameters:

obj (required): object
The object to compare with the current instance.

Returns:

Type: bool
true if the object is a DataBoundControl and equal to the current control; otherwise, false.

This is a sync method. Method runs synchronously.


OnValidating(sender, e)

Raises the Validating event with the provided arguments.

Parameters:

sender (required): object
The source of the event.

e (required): ValidatingEventArgs
The event data containing validation context and messages.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnPropertyChanging(sender, e)

Handles the property changing event.

Parameters:

sender (required): object
The source of the event.

e (required): PropertyChangingEventArgs<object>
The property changing event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


OnDoubleClick(sender, e)

Raises the DoubleClick event.

Parameters:

sender (required): object
The source of the event.

e (required): MouseEventArgs
The mouse event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetData()

Gets the control’s current data, including type, text, and value, as a structured object.

Returns:

Type: FormControlDataWithType
The structured control data.

This is a sync method. Method runs synchronously.


IsValid()

Returns a value indicating whether the control’s current value is valid.

Returns:

Type: bool
true if the value is valid; otherwise, false.

This is a sync method. Method runs synchronously.


OnClick(sender, e)

Raises the Click event.

Parameters:

sender (required): object
The source of the event.

e (required): MouseEventArgs
The mouse event arguments.

Returns:

Type: void
Method does not return anything

This is a sync method. Method runs synchronously.


GetHashCode()

Returns a hash code for the current control instance.

Returns:

Type: int
The hash code for the control.

This is a sync method. Method runs synchronously.